home *** CD-ROM | disk | FTP | other *** search
/ ETO Development Tools 1 / ETO Development Tools 1.iso / Essentials / Developer Essentials Jul 90 / Apple II / Programming & Utilities / Apple IIgs APW Intro Prog Src / HP.PAS / README.txt < prev    next >
Encoding:
Text File  |  1987-09-12  |  3.3 KB  |  59 lines
  1.  
  2. *
  3. * README -- General information about the Pascal version of HodgePodge
  4. *
  5.  
  6. The files in this directory are the source code for the Pascal version of
  7. HodgePodge, a sample program which demonstrates many features of the Apple
  8. IIGS tools.  To build the executable/launchable (type S16) load file, type
  9. "MAKE" at the prompt.  The executable file will be called "HP".
  10.  
  11. The file "MAKE" compiles the modules in reverse order of dependency, and then
  12. links the separate object modules using the script in the file "LINK".
  13.  
  14. Because HodgePodge was developed before the TML Pascal libraries and tool
  15. interface files for V1.1 were fully complete, there are certain pieces of
  16. source code which would have to be changed if HodgePodge were to be compiled
  17. under finished TML Pascal libraries V1.1 and up.  So instead of using the
  18. TML interface libraries, HodgePodge uses its own -- files "HPINTF.DATA.PAS",
  19. "HPINTF.PROC.PAS", and "HPINTF.P16.PAS".  These files contain only the
  20. toolbox constant, data type structure, and procedure/function definitions
  21. which HodgePodge requires.  Philosophically, these files are very similar to
  22. a MACGEN - generated assembly language macro file.  When the TML Pascal
  23. tool interface files have been sufficiently updated, it should be possible to
  24. remove the three aforementioned files, modify MAKE and LINK accordingly, and
  25. rebuild a new working version of HodgePodge.
  26.  
  27. In addition to removing the three files and implementing the MAKE and LINK
  28. file modifications outlined above, ALL occurrences of "IsToolError" and
  29. "ToolErrorNum" might have to be replaced with "toolErr".  Otherwise, all
  30. other toolbox calls and data structures are compatible with C and ASM65816.
  31.  
  32. Throughout the program, calls are made to error checking routines (such as
  33. CheckDiskError and CheckToolError) in "DIALOG.PAS".  Since these routines
  34. are called from many different places, they each take a "Where" integer
  35. parameter which is displayed along with the error message when an error
  36. occurs, facilitating the location of the operation which caused the error.
  37.  
  38.  
  39.  
  40. Files in this directory:
  41.  
  42. Name            Type                    Comments              Access  Subtype   
  43. README          TXT            This file                      DNBWR
  44. MAKE            SRC            EXEC file which builds HP      DNBWR   EXEC     
  45. LINK            SRC            LinkEd script file             DNBWR   LINKED   
  46. HP.PAS          SRC            Pascal source program          DNBWR   TMLPASCAL
  47. EVENT.PAS       SRC            Pascal source unit             DNBWR   TMLPASCAL
  48. MENU.PAS        SRC            Pascal source unit             DNBWR   TMLPASCAL
  49. WINDOW.PAS      SRC            Pascal source unit             DNBWR   TMLPASCAL
  50. PRINT.PAS       SRC            Pascal source unit             DNBWR   TMLPASCAL
  51. PAINT.PAS       SRC            Pascal source unit             DNBWR   TMLPASCAL
  52. FONT.PAS        SRC            Pascal source unit             DNBWR   TMLPASCAL
  53. DIALOG.PAS      SRC            Pascal source unit             DNBWR   TMLPASCAL
  54. GLOBALS.PAS     SRC            Pascal source unit             DNBWR   TMLPASCAL
  55. HPINTF.DATA.PAS SRC            Custom tool interface unit     DNBWR   TMLPASCAL
  56. HPINTF.PROC.PAS SRC            Custom tool interface unit     DNBWR   TMLPASCAL
  57. HPINTF.PDOS.PAS SRC            Custom tool interface unit     DNBWR   TMLPASCAL
  58. HP              S16            Executable load file           DNBWR
  59.